home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga News 95
/
Amiga News 95.iso
/
dpat
/
dpat96
/
povsetup_v1.0
/
povsetup.doc
< prev
next >
Wrap
Text File
|
1995-03-19
|
24KB
|
608 lines
POVSetup v1.0
© Copyright (06/01/95) Lejardinier Olivier
All Rights Reserved
1.) Licence
2.) Shareware
3.) Installation
4.) Introduction
5.) Système requis
6.) Démarrage
7.) Description de l'interface
8.) Mises à jour de POVSetup
9.) Contacter l'auteur
Il est conseillé de lire chronologiquement cette documentation
---------------------------------------------------------------------------
MUI v2.01+ - Magic User Interface
Copyright © 1992-94 Stefan Stunz - All Rights Reserved
ReqTools Library - The Requester Toolkit - Release 2.2b+
Copyright © 1991-1994 Nico François - All Rights Reserved
---------------------------------------------------------------------------
1.) Licence
-------------
Cette acceptation de licence se rapporte à tous les programmes, à tous les
manuels et disquettes du pack 'POVSetup', version 1.0 ou supérieure.
Le non-respect d'un ou plusieurs des points ci-dessous provoquera
l'expiration de la licence, c-à-d terminera vos droits d'utiliser ou de
manipuler (ex: distribuer) ce pack.
- Le prix de vente ne peut être supérieur aux frais de copie du logiciel,
(support, frais de copie/de port).
- L'archive de POVSetup doit être distribuée dans son intégralité
(programmes, documentations, données annexes, etc...).
La distribution d'une partie de l'archive n'est pas autorisée.
- Aucun fichiers contenu dans l'archive POVSetup ne peut être vendu avec un
produit commercial sans autorisation écrite de la part de l'auteur.
- Le contenu global de l'archive POVSetup ne peut être modifiée en aucune
façon.
Cependant j'autorise :
- la recompression de cette archive avec n'importe quel compresseur.
- la traduction de cette documentation dans une autre langue si et
seulement si le traducteur :
* traduit rigoureusement cette documentation.
* me fait parvenir son travail pour que je puisse l'inclure dans les
versions futures de POVSetup (voir "Contacter l'auteur").
- J'autorise la distribution (sur disquette ou CD-ROM) de l'archive
POVSetup dans les collections de programmes du domaine publique avec une
préférence pour l'Amiga Library (crée par Fred Fish) tant que le
distributeur de la dite collection suit scrupuleusement les différents
points décrits ci-dessus.
L'auteur se réserve le droit d'interdir ou d'interrompre à n'importe quel
moment la distribution à un distributeur si celui-ci viole, du point de
vue du propriétaire du copyright, un ou plusieurs points de cette licence.
Les profits résultants d'une distribution illégale devront être reversés au
propriétaire du copyright.
L'auteur fournit ce programme "tel quel". Le risque entier de l'utilisation
de ce programme vous appartient. L'auteur ne sera pas responsable des
dommages résultant de l'utilisation de son programme, ni, mais non limité
à celles-ci, des pertes de données résultant de l'utilisation directe ou
indirecte de ce programme.
2.) Shareware
---------------
POVSetup est un programme shareware :
N'étant pas un adepte des 'requesters shareware' et autres artifices
utilisés par les programmeurs pour contraindre l'utilisateur à payer le
droit d'utiliser un logiciel, je vous fais confiance en ce qui concerne le
support du shareware.
Donc, si vous utilisez souvent POVSetup ou tout simplement si vous voulez
me faire un don, veuillez m'envoyer 20 francs (français) UNIQUEMENT
EN ESPECES avec vos coordonnées à l'adresse suivante :
Lejardinier Olivier - POVSetup
9 rue Conti
76600 Le Havre
France
3.) Installation
------------------
Avant le lancement de la procédure d'installation, vous devez vous assurer
que le système MUI v2.01 ou supérieure ainsi que la librairie ReqTools v38
ou supérieure sont correctement installés
Copier le répertoire complet de POVSetup sur votre disque dur puis lancer
le programme 'Install_POVSetup'.
4.) Introduction
------------------
Ce programme a été créé à l'attention des utilisateur du programme de
raytracing 'Persistence Of Vision', communément appelé 'POV'.
Le principal but à atteindre lors de la création de ce programme était de
faciliter le règlage des quelques 15 paramètres du raytracer POV et ceci
grâce à l'utilisation d'une interface graphique créée avec le fabuleux
environnement MUI (Magic User Interface).
5.) Système requis
--------------------
Pour fonctionner, ce programme nécessite obligatoirement :
- l'OS 3.0 ou supérieur.
- le systéme MUI v2.01 ou supérieur.
- la ReqTools librairie v38 ou supérieure.
- le programme POV v1.0 ou supérieure.
- l'utilisation d'un processeur rapide, de suffisamment de mémoire et d'un
disque dur est grandement conseillée, voir indispensable.
6.) Démarrage
---------------
Démarrez le programme en double-cliquant sur son icône ou en tapant son nom
dans une fenêtre Shell ou CLI.
Si c'est la première fois que POVSetup est installé dans votre système, vous
devez, avant toute utilisation, effectuer un minimun de configuration dans
la partie de l'interface graphique appelée 'Config'.
L'accès aux différents gadgets de l'interface graphique sera décrit comme un
chemin d'accès.
Ex : Sélectionner un fichier .pov dans :
'Fichiers:Entrées Sorties/Fichier d'entrée'
-> Signifie : Aller dans le groupe 'Fichiers', puis dans
l'ensemble 'Entrées Sorties' et sélectionner
un fichier dans la zone 'Fichier d'entrée'
Note : La sélection d'un chemin d'accès ou d'un fichier dans un gadget
string se fait par l'intermédiaire d'un petit gadget bouton se
situant immédiatememt à droite de ce gadget string.
Configuration minimale à réaliser :
- Indiquer le chemin d'accès au programme POV dans :
'Config:POV/Programme POV :'
- Indiquer le chemin d'accès aux includes de POV dans :
'Config:POV/Include :'
- Indiquer le chemin d'accès aux programme de convertion de format
d'images dans :
'Config:Outils Supplémentaires/Convertisseur :'
Note : Je vous conseille d'utiliser le programme 'Dump2i24' fournit
avec le pack POV.
- Indiquer le chemin d'accès aux programme de visualisation d'images
dans :
'Config:Outils Supplémentaires/Visualiseur :'
Note : Je vous conseille d'utiliser le programme 'Viewtek' ou 'PPShow'
disponible dans la plupart des colections DP, ou à la rigueur
le programme 'Multiview' du Workbench se trouvant dans le
le répertoire 'SYS:Utilities/'
- Indiquer le chemin d'accès à l'éditeur de text dans :
'Config:Outils Supplémentaires/Editeur :'
Note : Vous pouvez par exemple utiliser le programme 'Ed' du Workbench
Pour l'instant, ne modifier pas les zones appelées 'Args :'
Langage :
---------
La bibliothèque Locale de l'OS 3.0 ou plus est gérée pour la localisation
de l'interface graphique ou des requètes de POVSetup. Actuellement, deux
langage sont disponibles :
- l'anglais (langage par défaut)
- le français (utilisé seulement si votre Workbench est
configué en français)
Note : Vous pouvez créer un catalogue dans votre langue, ceci en utilisant
le fichier de description 'povsetup.cd' et le fichier de traduction
'empty.ct' se trouvant dans le répertoire 'Locale' du répertoire de
POVSetup.
Interface graphique :
---------------------
Pour l'utilisation générale de l'interface graphique, se référer à la
documentation de MUI.
Note : Si vous êtes un utilisateur enregistré de MUI, je vous conseille
fortement de configurer POVSetup en 'XEN Lo'.
7.) Description de l'interface
--------------------------------
MUI offrant un nombre important de possibilités de configuration, surtout
si vous êtes un utilisateur enregistrés de MUI, il n'existe pas à priori
d'apparence "standard", des couleurs, résolutions, et des polices
de caractères pour l'interface graphique de POVSetup.
7.1) Fichiers
7.2) Image
7.3) Options
7.4) Config
7.5) Prefs
7.6) Contrôles
7.1) Fichiers
---------------
7.1.1) Fichiers:Entrées Sorties/Fichier d'entrée
7.1.2) Fichiers:Entrées Sorties/Editer
7.1.3) Fichiers:Entrées Sorties/Fichier de sortie
7.1.4) Fichiers:Entrées Sorties/Voir
7.1.5) Fichiers:Créer fichier de sortie
7.1.6) Fichiers:Convertir fichier de sortie
7.1.1) Fichiers:Entrées Sorties/Fichier d'entrée
---------------------------------------------------
Ce gadget permet de spécifier un fichier scéne POV soit en entrant
directement son nom dans le gadget string, soit en le sélectionnant avec le
popup gadget se trouvant complètement à droite.
Je vous conseille de nommer toutes vos scènes POV avec l'extension '.pov'
7.1.2) Fichiers:Entrées Sorties/Editer
----------------------------------------
Lorsque vous activerez ce gadget, le programme d'édition spécifié dans
'éditeur' sera lancé, vous permettant ainsi d'éditer la scène POV
sélectionnée dans 'fichier d'entrée'.
7.1.3) Fichiers:Entrées Sorties/Fichier de sortie
---------------------------------------------------
Ce gadget permet de spécifier un nom de fichier utiliser pour sauver l'image
calculée avec POV.
Le type de format de fichier est spécifier par 'Format du fichier de sortie'.
Je vous conseille de rajouter au nom du fichier l'extension correspondant au
type de fichier :
ex : Format 'Targa 24Bits' -> extension '.TGA'
Format 'Dump (QRT)' -> extension '.QRT'
Format 'Raw RGB' -> extension '.RAW'
Le fichier de sortie n'est créé que si l'option 'Créer fichier de sortie'
est activée.
Note : Si cette option est sélectionnée et si le nom du fichier de sortie
existe déjà, une confirmation vous sera demandée lors du lancement
du rendu.
7.1.4) Fichiers:Entrées Sorties/Voir
-------------------------------------
Ce gadget vous permet de visualiser l'image sélectionner dans
'fichier de sortie' avec le visualiseur sélectionner dans 'visualiseur'.
7.1.5) Fichiers:Créer fichier de sortie
-----------------------------------------
Ce gadget permet de spécifier si vous voulez ou non qu'un fichier soit créé
lors du rendu d'une scène.
Note : Si cette option est désélectionnée, le gadget permettant de
sélectionner le type de rendu ('Rendu', 'Continuer') est désactiver.
7.1.6) Fichiers:Convertir fichier de sortie
---------------------------------------------
Ce gadget permet de convertir le fichier se sortie en un autre format (par
ex convertion d'un fichier Dump QRT en IFF 24 bits), ceci grâce au programme
'Convertisseur'.
7.2) Image
------------
7.2.1) Image:Taille/Largeur de l'image
7.2.2) Image:Taille/Hauteur de l'image
7.2.3) Image:Taille/Présélections
7.2.4) Image:Taille/Taille /2
7.2.5) Image:Taille/Taille *2
7.2.6) Image:Limites/Début du rendu en ligne
7.2.7) Image:Limites/Fin du rendu en ligne
7.2.9) Image:Limites/Par défaut
7.2.10) Image:Format du fichier de sortie
7.2.1) Image:Taille/Largeur de l'image
----------------------------------------
Ce gadget permet de spécifier la largeur de l'image qui sera calculée.
Attention : certaines versions de POV ne gèrent pas des valeurs trop petites
ou trop grande de largeur d'image -> consulter votre manuel de
POV pour connaitre ces valeurs limites.
Pour modifier cette valeur vous pouvez utiliser les gadgets 'Préselections',
'Taille /2' et 'Taille *2'
7.2.2) Image:Taille/Hauteur de l'image
----------------------------------------
Ce gadget permet de spécifier la hauteur de l'image qui sera calculée.
Attention : certaines versions de POV ne gèrent pas des valeurs trop petites
ou trop grande de hauteur d'image -> consulter votre manuel de
POV pour connaitre ces valeurs limites.
Pour modifier cette valeur vous pouvez utiliser les gadgets 'Préselections',
'Taille /2' et 'Taille *2'
7.2.3) Image:Taille/Présélections
-----------------------------------
Ce gadget permet de sélectionner une taille prédéfinie d'image.
Le choix de tailles offert dépend du nombre de 'Monitors' installer dans
votre système.
7.2.4) Image:Taille/Taille /2
-------------------------------
Ce gadget permet de diviser par 2 les valeurs se trouvant dans les zones
'largeur' et 'hauteur'.
Lorsque ces valeurs ne peuvent plus être divisées par 2, ce gadget est
désactivé.
7.2.5) Image:Taille/Taille *2
-------------------------------
Ce gadget permet de multiplier par 2 les valeur se trouvant dans les zones
'largeur' et 'hauteur'.
Lorsque ces valeurs ne peuvent plus être multipliées par 2, ce gadget est
désactivé.
7.2.6) Image:Limites/Début du rendu en ligne
----------------------------------------------
Ce gadget permet de spécifier à quelle ligne de l'image doit débuter le
rendu.
Cela permet de ne faire le rendu que d'une partie de l'image, afin par ex de
vérifier un détail particulier de la scène.
Cette valeur peut être remise à zéro grâce au gadget 'par défaut' situé
juste à coté.
7.2.7) Image:Limites/Fin du rendu en ligne
--------------------------------------------
Ce gadget permet de spécifier à quelle ligne de l'image doit se terminer
le rendu.
Cela permet de ne faire le rendu que d'une partie de l'image, afin par ex de
vérifier un détail particulier de la scène.
Cette valeur peut être remise à sa valeur par défaut grâce au gadget
'par défaut' situé juste à côté.
7.2.9) Image:Limites/Par défaut
---------------------------------
Ce gadget permet de réinitialiser la valeur du gadget situé à gauche.
'Début du rendu en ligne' -> par défaut = 0
'Fin du rendu en ligne' -> par défaut = 'hauteur de l'image'
7.2.10) Image:Format du fichier de sortie
-------------------------------------------
Ce gadget permet de spécifier le type de format du fichier de sortie que
devra générer POV lors du rendu.
7.3) Options
--------------
7.3.1) Options:Options de rendu/Afficher progression du rendu
7.3.2) Options:Options de rendu/Prévisualisation
7.3.3) Options:Options de rendu/Antialiasing
7.3.4) Options:Options de rendu/Qualité
7.3.5) Options:Cache de disque
7.3.6) Options:Pile
7.3.7) Options:Priorité
7.3.1) Options:Options de rendu/Afficher progression du rendu
---------------------------------------------------------------
Cette option, si elle est activée, indiquera à POV d'ouvrir une fenêtre
d'informations sur le rendu en cours.
7.3.2) Options:Options de rendu/Prévisualisation
--------------------------------------------------
Cette option, si elle activée, indiquera à POV d'afficher un prérendu du
rendu en cours, suivant le type d'affichage spécifié dans le gadget situé
à droite.
Note : Le type d'affichage doit être choisi en fonction du matériel dont
vous disposez (cf doc POV).
7.3.3) Options:Options de rendu/Antialiasing
----------------------------------------------
Cette option, si elle est activée, permet de spécifier le niveau
d'antialiasing utilisé lors du rendu.
Vous pouvez modifiez cette valeur en utilisant le slider se trouvant à côté.
Note : POV gère la valeur de l'antialiasing d'une façon particulière :
-> plus cette valeur est BASSE, plus l'antialiasing est ELEVE.
Pour les valeurs idéales, voir doc POV.
7.3.5) Options:Cache de disque
--------------------------------
Cette option, si elle activée, permet de définir le cache du disque utilisé
avant d'écrire les données de l'image sur le support.
Si cette option est désactivée, les données seront écrites immédiatement sur
le support.
7.3.6) Options:Pile
---------------------
Cette option permet de spécifier la taille de la pile utilisée par le
programme POV.
Note : Une valeur incorrecte de pile peut entraînée un plantage du système.
7.3.7) Options:Priorité
-------------------------
Cette option permet de définir le niveau de priorité d'éxecution du
programme POV lor d'un rendu.
Note : Une valeur TROP élevée de priorité peut entraînée un
disfonctionnement du système d'exploitation (gestion de la souris
ralentie, etc...)
7.4) Config
-------------
7.4.1) Config:POV/Programme POV
7.4.2) Config:POV/Include
7.4.3) Config:Outils supplémentaires/Convertisseur
7.4.4) Config:Outils supplémentaires/Visualiseur
7.4.5) Config:Outils supplémentaires/Editeur
7.4.1) Config:POV/Programme POV
---------------------------------
Dans ce gadget, vous devez spécifier le chemin d'accès au programme POV.
7.4.2) Config:POV/Include
---------------------------
Dans ce gadget, vous devez spécifier le chemin d'accès aux includes de POV.
Note : POVSetup rajoute le répertoire où se trouve la scène POV sélectionnée
aux chemins de recherche des includes de POV.
7.4.3) Config:Outils supplémentaires/Convertisseur
----------------------------------------------------
Dans ce gadget, vous devez spécifier le programme de conversion de format
de fichier image. C'est ce programme qui est utilisé lorsque vous pressez
le gadget 'convertir fichier de sortie'.
Comme arguments, vous devez spécifier dans 'Args:' '%s %s<chaine>' où
<chaine> est une chaine de caractère à rajouter au nom du fichier de sortie.
Ex : En admettant que le convertisseur crée un fichier IFF 24 bits, vous
pouvez spécifier '%s %sIFF24Bits' dans le gadget 'Args :'.
7.4.4) Config:Outils supplémentaires/Visualiseur
--------------------------------------------------
Dans ce gadget, vous devez spécifier le programme de visualisation d'images
qui sera utilisé lorsue vous activerez le gadget 'Voir'.
En arguments, vous devez spécifier au moins un '%s' qui sera remplacé par le
nom du fichier de sortie.
7.4.5) Config:Outils supplémentaires/Editeur
----------------------------------------------
Dans ce gadget, vous devez spécifier le programme d'édition de texte, qui
sera utilisez lorsque vous activerez le gadget 'Editer'.
En arguments, vous devez spécifier au moins un '%s', qui sera remplacé par
le nom du fichier d'entrée.
7.5) Prefs
------------
7.5.1) Sauver prefs
7.5.2) Charger prefs
7.5.1) Sauver prefs
---------------------
Ce gadget vous permet de sauver les préférences courantes de l'interface
POVSetup.
Vous pouvez sauver les préférences globalement (choix 'défaut' du requester)
ou pour chaque fichier scène (choix 'Autre' du requester).
Si vous choisissez de sauver les préférences uniquement pour un fichier
scène particulier, l'extension '.PSCfg' sera rajouté au nom du fichier
d'entrée.
7.5.2) Charger prefs
----------------------
Ce gadget vous permet de charger les préférences par défaut ou d'un fichier
scène particulier.
7.6) Contrôles
----------------
7.6.1) Contrôles:Commencer
7.6.2) Contrôles:Rendu
7.6.3) Contrôles:Continuer
7.6.4) Contrôles:Stopper
7.6.5) Contrôles:Infos
7.6.6) Contrôles:Iconifier
7.6.7) Contrôles:Quitter
7.6.1) Contrôles:Commencer
----------------------------
Ce gadget vous permet de démarrer le rendu de la scène POV sélectionnée.
7.6.2) Contrôles:Rendu
------------------------
Si cette option est activée, un nouveau rendu sera commencé pour la scène
POV sélectionnée.
7.6.3) Contrôles:Continuer
---------------------------
Cette option vous permet de continuer un rendu prècédement stoppé avec le
gadget 'stopper'.
7.6.4) Contrôles:Stopper
--------------------------
Ce gadget vous permet d'interrompre le rendu en cours.
Note : Il peut arriver qu'un rendu se soit terminé sans que POVSetup en soit
averti, dans ce cas le programme vous le signalera (ce n'est pas un
bug !!).
7.6.5) Contrôles:Infos
------------------------
Ce gadget vous permet d'obtenir diverses informations sur le programme
POVSetup.
7.6.6) Contrôles:Iconifier
----------------------------
Ce gadget vous permet d'iconifier l'interface.
7.6.7) Contrôles:Quitter
--------------------------
Ce gadget vous permet de quitter POVSetup.
8.) Mises à jour de POVSetup
------------------------------
Si je continue à développer Kondike ADPTools, les prochaines mise à jour
seront disponible dans les diverses collections de programmes du domaine
publique.
9.) Contacter l'auteur
------------------------
Vous êtes libre de m'envoyer des rapports de bogues, des commentaires, ou
des suggestions, à l'adresse suivante :
Lejardinier Olivier - POVSetup
9 rue Conti
76600 Le Havre
France